home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 4 / BBS in a Box - Macintosh - Volume IV (January 1992) (BBS in a Box).iso / Files / Prog / M / LSC 2.13 ReleaseNotes < prev    next >
Encoding:
Text File  |  1987-11-21  |  5.6 KB  |  135 lines  |  [TEXT/MACA]
  1.  
  2. LightspeedC v2.13
  3. Release Notes
  4. 11/9/87
  5.  
  6. Version 2.11 corrected some compatiblity problems related to new Apple
  7. hardware and software, and supplied preliminary interfaces to the new
  8. ROM calls.  This version adds MultiFinder compatibility, and updates
  9. the interfaces to their final form.
  10.  
  11. The upgrade is provided in the form of a patch program, new #include
  12. files, and new libraries.  It is not necessary to recompile any code
  13. after upgrading, but you should remember to load the new libraries.
  14.  
  15.  
  16. About the patch program
  17. -----------------------
  18.  
  19. The patch program, "Patch LSC => 2.13", transforms your version 2.01
  20. or 2.11 into version 2.13.  You are prompted for a file containing the
  21. copy of LightspeedC to be patched.  Patch a copy, not your original!
  22. If the patch program encounters an error, the LightspeedC being patched
  23. may not be left in a consistent state, so start again with a fresh copy.
  24.  
  25.  
  26. About the #include files
  27. ------------------------
  28.  
  29. The #include files supplied with this release completely replace the
  30. existing Mac #includes.  The preliminary "x..." files supplied with
  31. the 2.11 release have been updated and consolidated into the mainstream
  32. set of #includes.
  33.  
  34. For the most part, the organization of the #include files follows that
  35. of Inside Macintosh.  However, some chapters have been combined.  The
  36. file "Color.h" corresponds to the "Color Quickdraw", "Graphics Devices",
  37. "Color Manager", "Palette Manager", and "Color Picker Package" chapters
  38. of Volume V.  Data structures describing the color extensions to the
  39. Control Manger, Menu Manager, and Window Manager have been combined as
  40. "ColorToolbox.h".  Finally, interfaces to SysEnvirons, the Deferred Task
  41. Manager, and the ShutDown Manager appear in "OSUtil.h".
  42.  
  43.  
  44. About the libraries
  45. -------------------
  46.  
  47. The "PrLink.Lib" library is no longer distributed.  Print Manager
  48. interfaces are now contained in "MacTraps".
  49.  
  50. The "Appletalk.Lib" library and its accompanying resource file, "ATalk/
  51. ABPackage", are no longer distributed.  They have been replaced by a
  52. new library, "Appletalk".  Additional Appletalk interfaces are contained
  53. in "MacTraps".  See "About Appletalk", below, for more information.
  54.  
  55. "MacTraps" has gotten larger in this release.  This is due in part to
  56. the incorporation of Print Manager and Appletalk interfaces, and in part
  57. to other new interfaces described in Volume V of Inside Macintosh.  In
  58. addition, the new "MacTraps" contains a great deal more information for
  59. use by the "smart" linker.  This means that "Build" is able to strip
  60. away a greater amount of unused code than before.  When you "Build"
  61. your projects with version 2.13, you may find that they get smaller!
  62.  
  63.  
  64. About MultiFinder
  65. -----------------
  66.  
  67. When MultiFinder is in use, the "Run" and "Transfer" commands do not
  68. cause LightspeedC to exit.  (It is not possible to quit LightspeedC while
  69. a project is running.)
  70.  
  71. In general, two megabytes of memory are required to use LightspeedC
  72. with MultiFinder.  However, it may be feasible to develop very small
  73. projects in only one megabyte by reducing LightspeedC's size requirements
  74. using the Finder's "Get Info" command.  It is also necessary to install
  75. a 'SIZE',0 resource in the project document, to get the project to run
  76. in a small partition.
  77.  
  78.  
  79. About "sub-launching"
  80. ---------------------
  81.  
  82. Apple Technical Note #126 describes "sub-launching".  Under MultiFinder,
  83. it is possible to launch an application without exiting.  For technical
  84. reasons, though, it is difficult to use this feature in LightspeedC.  So
  85. the new "MacTraps" library defines a function to do it for you:
  86.  
  87.     extern int SubLaunch(char *appl, int fdFlags);
  88.  
  89. The first argument, "appl", is a pascal string giving the name of the
  90. program to launch.  It is up to you to set the current directory (using
  91. SetVol) before calling SubLaunch.  The second argument, "fdFlags", is
  92. the flags word from the finder information record (FInfo); it can be
  93. obtained by calling GetFInfo.  (See Tech Note #126 for details.)  A
  94. negative return result from SubLaunch indicates that the attempt failed;
  95. any other result indicates success.
  96.  
  97. WARNING: If bit 6 (0x0040) is set in "fdFlags", MultiFinder will ignore
  98. the various flag bits in the application's SIZE resource.  These bits
  99. determine whether the application is "MultiFinder-aware" and whether it
  100. is to receive suspend/resume events and background null events.  Apple
  101. has acknowledged this as a bug in MultiFinder 1.0.  We recommend always
  102. passing 0 for "fdFlags".
  103.  
  104.  
  105. About Appletalk
  106. ---------------
  107.  
  108. There are now two sets of Appletalk interfaces, which Apple calls the
  109. "preferred" set and the "alternate" set.  Either or both may be used.
  110.  
  111. The original Appletalk calls introduced in Volume II of Inside Macintosh
  112. are now considered the "alternate" set.  The new, "preferred" calls appear
  113. in Volume V of Inside Macintosh.
  114.  
  115. Until this release, Appletalk interfaces were provided in the form of
  116. a library, "Appletalk.Lib", and a resource file, "ATalk/ABPackage".
  117. These have now been consolidated into a single library, "Appletalk".
  118. This library constitutes the "alternate" set.  The #include file
  119. "Appletalk.h" defines data structures necessary when using these calls.
  120.  
  121. Interfaces to the "preferred" set are contained in "MacTraps".  The
  122. #include file "nAppletalk.h" defines data structures necessary when
  123. using these calls.
  124.  
  125. The above information is summarized in the following table:
  126.  
  127.                         "preferred"        "alternate"        2.01/2.11
  128.                             
  129.     interface code:        MacTraps        Appletalk        Appletalk.Lib
  130.     #include file:        nAppletalk.h    Appletalk.h        Appletalk.h
  131.     resource file:        (n/a)            (n/a)            ATalk/ABPackage
  132.  
  133. Remember, if you are using only the "preferred" calls, there is no need
  134. to load the "Appletalk" library into your project.